Tweak completion documentation

Use lexical-binding and require cl-lib

* net/rcirc.el (rcirc, rcirc-handler-ctcp-KEEPALIVE)
(rcirc-handler-generic, rcirc-fill-paragraph)
(rcirc-format-response-string, rcirc-target-buffer)
(rcirc-last-line, rcirc-record-activity, rcirc-split-activity)
(rcirc-activity-string, rcirc-make-trees, rcirc-cmd-ctcp)
(rcirc-ctcp-sender-PING, rcirc-browse-url)
(rcirc-markup-timestamp, rcirc-markup-attributes)
(rcirc-markup-my-nick, rcirc-markup-urls)
(rcirc-markup-bright-nicks, rcirc-markup-fill)
(rcirc-check-auth-status, rcirc-handler-WALLOPS)
(rcirc-handler-JOIN, rcirc-handler-PART-or-KICK)
(rcirc-handler-PART, rcirc-handler-KICK, rcirc-handler-QUIT)
(rcirc-handler-NICK, rcirc-handler-PING, rcirc-handler-PONG)
(rcirc-handler-TOPIC, rcirc-handler-301, rcirc-handler-317)
(rcirc-handler-332, rcirc-handler-333, rcirc-handler-477)
(rcirc-handler-MODE, rcirc-handler-353, rcirc-handler-366)
(rcirc-authenticate, rcirc-handler-INVITE, rcirc-handler-ERROR)
(rcirc-handler-ctcp-VERSION, rcirc-handler-ctcp-TIME)
(rcirc-handler-CTCP-response): Fix unused arguments warnings and
use cl-lib.

ChangeLog fixes

Merged entries get today's date.
May as well combine consecutive separate entries by same author into one.
Backported entries should not appear twice.

Merge from emacs-24; up to 2014-04-01T20:18:12Z!eggert@cs.ucla.edu

* alloc.c: Simplify by removing use of HAVE_EXECINFO_H.

We have a substitute execinfo.h on hosts that lack it.
(suspicious_free_history): Make it EXTERNALLY_VISIBLE so it
isn't optimized away.

* src/alloc.c: Keep track of symbols referenced from pure space (bug#17168).
(symbol_block_pinned): New var.
(Fmake_symbol): Initialize `pinned'.
(purecopy): New function, extracted from Fpurecopy.  Mark symbols as
pinned and signal an error for un-purifiable objects.
(pure_cons): Use it.
(Fpurecopy): Use it, except for objects that can't be purified.
(mark_pinned_symbols): New function.
(Fgarbage_collect): Use it.
(gc_sweep): Remove hack made unnecessary.
* src/lisp.h (struct Lisp_Symbol): New bitfield `pinned'.

Auto-commit of loaddefs files.

Improve on previous quote autopairing change

Backported from trunk 2014-04-04T23:31:02Z!joaotavora@gmail.com

* lisp/elec-pair.el:
(electric-pair--syntax-ppss): When inside comments parse from
comment beginning.
(electric-pair--balance-info): Fix typo in comment.
(electric-pair--in-unterminated-string-p): Delete.
(electric-pair--unbalanced-strings-p): New function.
(electric-pair-string-bound-function): New var.
(electric-pair-inhibit-if-helps-balance): Decide quote pairing
according to `electric-pair--in-unterminated-string-p'

* test/automated/electric-tests.el (define-electric-pair-test): Don't
overtest..
(inhibit-in-mismatched-string-inside-ruby-comments): New test.
(inhibit-in-mismatched-string-inside-c-comments): New test.

Inhibit quote autopairing more frequently

Backported from trunk 2014-04-02T09:59:06Z!joaotavora@gmail.com

* lisp/elec-pair.el (electric-pair-inhibit-if-helps-balance): Inhibit
quote pairing if point-max is inside an unterminated string.
(electric-pair--looking-at-unterminated-string-p):
Delete.
(electric-pair--in-unterminated-string-p): New function.

* test/automated/electric-tests.el (inhibit-if-strings-mismatched):
New test, change from `inhibit-only-of-next-is-mismatched'.

* lisp/shell.el (shell-directory-tracker): Go back to just ignoring failures.

Fixes: debbugs:17159

lisp/ChangeLog, src/ChangeLog: Fix typos.

ChangeLog fix

Fix electric-pair-delete-adjacent-pairs in modes binding backspace.

* lisp/elec-pair.el (electric-pair-backward-delete-char): Delete.
(electric-pair-backward-delete-char-untabify): Delete.
(electric-pair-mode-map): Bind backspace to a menu item filtering
a new `electric-pair-delete-pair' command.
(electric-pair-delete-pair): New command.

Fixes: debbugs:16981

Fix triple-quoting electricity in python-mode

* lisp/progmodes/python.el (python-electric-pair-string-delimiter): Fix
triple-quoting electricity.

* test/automated/python-tests.el (python-triple-quote-pairing): New test.
(python-syntax-after-python-backspace): New test.

Fixes: debbugs:17192

Fix electric-pair-skip-whitespace with quotes in text-mode

* lisp/elec-pair.el (electric-pair-post-self-insert-function): Don't
skip whitespace for quote syntax when `electric-pair-text-pairs'
and `electric-pair-pairs' were used.

* test/automated/electric-tests.el (electric-pair-define-test-form):
More readable test docstrings.
(whitespace-skipping-for-quotes-not-ouside)
(whitespace-skipping-for-quotes-only-inside)
(whitespace-skipping-not-without-proper-syntax):

Fixes: debbugs:17183

* lisp/gnus/gnus-srvr.el (gnus-tmp-how, gnus-tmp-name, gnus-tmp-where)
(gnus-tmp-status, gnus-tmp-agent, gnus-tmp-cloud)
(gnus-tmp-news-server, gnus-tmp-news-method, gnus-tmp-user-defined):
Silence compiler warnings.
(gnus-server-insert-server-line): Don't use dyn-bind var as argument.

* lisp/dired-aux.el (dired-file-set-difference): Use lexical-scoping.

src/bidi.c: Describe the design of reordering engine in the commentary.

Fix bug #17199 with incorrect character produced by ipa-x-sampa IM.

 lisp/leim/quail/ipa.el (ipa-x-sampa): Fix the character produced for "<F>".

* lisp/mpc.el (mpc--status-timer-run): Disable timer if not displayed.
(mpc--status-idle-timer-run): Use mpc--status-timer-run.

Prefer 'ARRAYELTS (x)' to 'sizeof x / sizeof *x'.

* alloc.c (memory_full):
* charset.c (syms_of_charset):
* doc.c (Fsnarf_documentation):
* emacs.c (main):
* font.c (BUILD_STYLE_TABLE):
* keyboard.c (make_lispy_event):
* profiler.c (setup_cpu_timer):
* xgselect.c (xg_select):
* xterm.c (record_event, STORE_KEYSYM_FOR_DEBUG):
Use ARRAYELTS.
* font.c (FONT_PROPERTY_TABLE_SIZE): Remove.
Replace the only use with ARRAYELTS (font_property_table).
* xfaces.c (DIM): Remove.  All uses replaced by ARRAYELTS.

ChangeLog fix

Related entries do not get separated by blank lines (per standards.info).
Use form from admin/notes/changelogs for repeated items.

Minor doc updates related to dribble files

* doc/emacs/trouble.texi (Checklist):
* doc/lispref/os.texi (Recording Input): Dribble files may contain passwords.

* lisp/help.el (view-lossage): Doc tweak.

* src/keyboard.c (Fopen_dribble_file): Doc tweak.

Auto-commit of loaddefs files.

Fix bug #16434 with handling the -rv command-line option.

 lisp/faces.el (make-face-x-resource-internal): Do nothing when
 inhibit-x-resources is non-nil.  Don't touch the default face if
 reversed video is given--as was done in previous versions of Emacs.
 (face-set-after-frame-default): Don't call
 make-face-x-resource-internal here.

Fix bug #16378 with mishandling of empty faces.

 lisp/faces.el (face-spec-choose): Accept additional optional argument,
 whose value is returned if no matching attributes are found.
 (face-spec-recalc): Use the new optional argument when calling
 face-spec-choose.

Fix bug #16694 with theme face precedence.

 lisp/faces.el (face-spec-recalc): Call make-face-x-resource-internal
 only when inhibit-x-resources is nil, and do that earlier in the
 function.  Doc fix.

* emacs-lisp/lisp-mode.el (lisp-imenu-generic-expression): Add
define-compilation-mode.

Improve on previous quote autopairing change

* lisp/elec-pair.el:
(electric-pair--syntax-ppss): When inside comments parse from
comment beginning.
(electric-pair--balance-info): Fix typo in comment.
(electric-pair--in-unterminated-string-p): Delete.
(electric-pair--unbalanced-strings-p): New function.
(electric-pair-string-bound-function): New var.
(electric-pair-inhibit-if-helps-balance): Decide quote pairing
according to `electric-pair--in-unterminated-string-p'

* test/automated/electric-tests.el (define-electric-pair-test): Don't
overtest..
(inhibit-in-mismatched-string-inside-ruby-comments): New test.
(inhibit-in-mismatched-string-inside-c-comments): New test.

* lisp/textmodes/reftex-parse.el (reftex--index-tags): Rename `index-tags'.
Move declaration before first use.
(reftex-move-to-next-arg): Silence compiler warning.

Fix bug#16090.

* lisp/doc-view.el (doc-view-bookmark-jump): Use
`bookmark-after-jump-hook' to jump to the right page after the
buffer is shown in a window.

* lisp/erc/erc.el (erc-invite-only-mode, erc-toggle-channel-mode): Simplify.
(erc-load-script): Tighten a regexp.

src/buffer.h, src/frame.h: Clarify doc of optimization variables.

Backport from trunk.
       * nsmenu.m (update_frame_tool_bar): Return early if view or toolbar
is nil.  If waiting for toolbar to complete, force a redraw.
(free_frame_tool_bar): Set wait_for_tool_bar = NO

       * nsterm.h (EmacsView): Add wait_for_tool_bar.

* nsterm.m (updateFrameSize:): If waiting for the tool bar and tool
       bar is zero height, just return (Bug#16976).
       (initFrameFromEmacs:): Initialize wait_for_tool_bar.

src/keyboard.c: Fix a typo in a comment to read_char.

Use `window-total-width' instead of `window-width'.

* textmodes/reftex-toc.el (reftex-toc, reftex-re-enlarge): Use
`window-total-width' instead of `window-width'.

A better fix for bug #17169.

 lisp/international/characters.el (mirroring): Fix last change:
 instead of loading uni-mirrored.el explicitly, do that implicitly
 by creating the 'mirroring' uniprop table.  This avoids announcing
 the loading of uni-mirrored.el.

Doc updates for buffer-stale-function now applying to file buffers too

* doc/emacs/arevert-xtra.texi (Supporting additional buffers):
* doc/lispref/backups.texi (Reverting):
Update for buffer-stale-function also applying to file-buffers.

* lisp/autorevert.el (auto-revert-buffers):
* lisp/files.el (buffer-stale--default-function)
(buffer-stale-function, revert-buffer--default): Doc tweaks.

* etc/NEWS: Related edits.

Doc updates for default values of some -function vars no longer being nil

* doc/emacs/files.texi (Backup Names):
* doc/emacs/arevert-xtra.texi (Supporting additional buffers):
* doc/lispref/backups.texi (Making Backups, Reverting):
Update for default values of some -function vars no longer being nil.

* etc/NEWS: Related edits.

Rename EARRAYSIZE to ARRAYELTS

Fix bug #17169 with infinite recursion in bidi_initialize under force-load-messages.

 lisp/international/characters.el: Preload uni-mirrored.el.

Don't use manifest on Cygwin.  (Bug#17176)

* nt/emacs.rc: Don't use manifest on Cygwin.
* configure.ac (EMACS_MANIFEST, UPDATE_MANIFEST): Leave these
variables empty on Cygwin.
* src/Makefile.in (EMACS_MANIFEST): Update comment.

Refix previous NEWS fix

Tweak previous NEWS change

Clean up array size calculations

Doc updates related to changes in revert-buffer function variables

* lisp/files.el (make-backup-file-name-function)
(make-backup-file-name, make-backup-file-name--default-function)
(make-backup-file-name-1, find-backup-file-name)
(revert-buffer-function, revert-buffer-insert-file-contents-function)
(buffer-stale--default-function, buffer-stale-function)
(before-revert-hook, after-revert-hook, revert-buffer-in-progress-p)
(revert-buffer, revert-buffer--default)
(revert-buffer-insert-file-contents--default-function):
Doc fixes related to defaults no longer being nil.
(make-backup-file-name-function): Bump :version.
Restore nil as a valid but deprecated custom type.

* etc/NEWS: Related edit.

* make-dist: Further update AC_INIT regexp.

Add missing src/ChangeLog text that somehow ended up in last commit message instead

* lisp/progmodes/perl-mode.el (perl-syntax-propertize-function): Handle $'
used as a variable.

Fixes: debbugs:17174

Fix typo

* alloc.c: Include execinfo.h if available.
(SUSPICIOUS_OBJECT_CHECKING): New macro; define unconditionally.
(suspicious_free_record): New structure.
(suspicious_objects,suspicious_object_index)
(suspicious_free_history, suspicious_free_history_index): New
variables.
(find_suspicious_object_in_range,detect_suspicious_free,Fsuspicious_object):
New functions.
(cleanup_vector): Call find_suspicious_object_in_range.

Add GC bug investigation code

* lisp/progmodes/perl-mode.el (perl-syntax-propertize-function): Add "foreach"
and "for" statement modifiers introducing expressions.

Fixes: debbugs:17116

* lisp/progmodes/perl-mode.el (perl-indent-new-calculate):
Handle forward-sexp failure.

Fixes: debbugs:16985

Revert subr.el workaround for GC bug.

* subr.el (set-transient-map): Comment out previous change.

* xterm.c (x_term_init) [USE_LUCID]: Fix minor memory leak.

Merge from emacs-24; up to 2014-03-28T01:39:30Z!rgm@gnu.org

In x_new_font don't calculate non-toolkit scrollbar width from font width (Bug#17163).

* xterm.c (x_new_font): Don't calculate non-toolkit scrollbar
width from font width (Bug#17163).

* font.c (font_list_entities): Do not add empty vector to font cache.
(font_matching_entity): Likewise.  If matching entity is found, insert
1-item vector with this entity instead of entity itself (Bug#17125).

Inhibit quote autopairing more frequently

* lisp/elec-pair.el (electric-pair-inhibit-if-helps-balance): Inhibit
quote pairing if point-max is inside an unterminated string.
(electric-pair--looking-at-unterminated-string-p):
Delete.
(electric-pair--in-unterminated-string-p): New function.

* test/automated/electric-tests.el (inhibit-if-strings-mismatched):
New test, change from `inhibit-only-of-next-is-mismatched'.

Small codes update for revert-buffer-function no longer being nil by default

* lisp/menu-bar.el (menu-bar-file-menu):
* lisp/vc/ediff.el (ediff-current-file):
Update for revert-buffer-function no longer being nil by default.

NEWS small edits

* lisp/simple.el (command-execute): Respect nil disabled-command-function.

Fix for command-execute handling of disabled commands

* lisp/simple.el (command-execute): Do not execute the command when it
is disabled; fixes thinko in 2013-02-20 conversion from C.

Fixes: debbugs:17151

Prevent assertion failure when trying to complete the prompt

* fns.c (validate_subarray): Rename from validate_substring,

since it works for vectors too.  New arg ARRAY.  Optimize for the
non-nil case.  Instead of returning bool, throw an error if out of
range, so that the caller needn't do that.  All uses changed.
Report original values if out of range.
(Fsubstring, Fsubstring_no_properties, secure_hash):
Also optimize the case where FROM is 0 or TO is the size.

Backport cedet/ede/emacs.el change from trunk
In case anyone uses 24.4 to edit trunk Emacs sources

* lisp/cedet/ede/emacs.el (ede-emacs-version): Update AC_INIT regexp.

Fixes: debbugs:17160

configure.ac comment

* lisp/cedet/ede/emacs.el (ede-emacs-version): Update AC_INIT regexp.

Fixes: debbugs:17160

* NEWS: `url-handler-mode' passes operations to Tramp for some protocols.

Pass some protocols to Tramp, like ssh and friends.

* url-tramp.el: New file.

* url-handlers.el (url-handler-regexp): Add ssh, scp, rsync and telnet.
Add :version.
(url-file-handler): Call `url-tramp-file-handler' if appropriate.

Auto-commit of loaddefs files.

Auto-commit of loaddefs files.

Fix up some Version: headers that might confuse package.el

Rename some cedet Version: headers that can confuse package.el

Fixes: debbugs:17137

* configure.ac: Make the final "Does Emacs use Gsettings" message
consistent with src/config.h.

* fns.c (Fsubstring, Fsubstring_no_properties, secure_hash):
Move common substring range checking code to...
(validate_substring): ...this function.

* search.c (Freplace_match): Use make_specified_string.
* xterm.c, w32term.c (x_set_glyph_string_gc): Use emacs_abort
to catch bogus override face of glyph strings.

* nsmenu.m (free_frame_tool_bar): Set wait_for_tool_bar = NO

Fixes: debbugs:16976

* configure.ac: Fix errors from previous checkin (GSettings check).
Backport from trunk.

* configure.ac: Fix errors from previous checkin (GSettings check).

Discuss using lazy completion tables for inline completion.

* emacs-lisp/eldoc.el (eldoc-print-current-symbol-info): Refactor
out eldoc-documentation-function-default.
(eldoc-documentation-function-default): New function.
(eldoc-documentation-function): Change value.

Sync some vhdl changes that seem to have been missed from some previous merge

* lisp/progmodes/vhdl-mode.el (vhdl-speedbar-select-mra)
(vhdl-compose-components-package, vhdl-compose-configuration):
Abbreviate default-directory.

* lisp/simple.el (cycle-spacing--context, cycle-spacing): Doc tweaks.

Include restoring manual line-breaks to state before 2014-03-28T16:26:15Z!mina86@mina86.com.

Sync with upstream vhdl mode v3.35.2.

Ref: http://lists.gnu.org/archive/html/emacs-devel/2014-03/msg01137.html

* lisp/progmodes/vhdl-mode.el (vhdl-version, vhdl-time-stamp): Update.
(top-level): No longer require assoc.
(vhdl-asort, vhdl-anot-head-p, vhdl-aput, vhdl-adelete, vhdl-aget):
New functions.  Use throughout to replace aget etc.
(vhdl-aput-delete-if-nil): Rename from vhdl-aput.
(vhdl-update-file-contents): Update for vhdl-aput-delete-if-nil rename.
(vhdl-template-replace-header-keywords): Fix bug for "<title string>".
(vhdl-compile-init): Do not initialize regexps for Emacs 22+.
(vhdl-error-regexp-emacs-alist): Remove regexps from all compilers
except `vhdl-compiler'.
(vhdl-error-regexp-add-emacs): Remove all other compilers,
when appropriate.

vhdl-mode.el small fixup

* lisp/progmodes/vhdl-mode.el (vhdl-expand-abbrev, vhdl-expand-paren):
Revert 2014-03-26 merge goof; go back to using defalias.

Ref: http://lists.gnu.org/archive/html/emacs-devel/2014-03/msg01104.html

* configure.ac: Include GFILENOTIFY objects in glib check (backport from trunk)

Fixes: debbugs:17069

completion-in-region-mode improvements

nt/INSTALL: Minor fixes.

Avoid flickering on frame creation with tool bar on OSX.

* nsmenu.m (update_frame_tool_bar): Return early if view or toolbar
is nil.  If waiting for toolbar to complete, force a redraw.

* nsterm.h (EmacsView): Add wait_for_tool_bar.

* nsterm.m (updateFrameSize:): If waiting for the tool bar and tool
bar is zero height, just return.
(initFrameFromEmacs:): Initialize wait_for_tool_bar.

Fixes: debbugs:16976

In x_set_window_size postpone calculation of default frame sizes (Bug#17142).

* frame.c (x_set_frame_parameters): Calculate default values of
new frame sizes only after all other frame parameters have been
processed (Bug#17142).

Auto-commit of loaddefs files.

* configure.ac: Add check that GSettings is in libgio. Backport from trunk.

Fixes: debbugs:17118

* lisp/dired-aux.el (dired-compress-file): Don't use string-match-p
because its match data is used afterwards.

* configure.ac: Add check that GSettings is in libgio.

Fixes: debbugs:17118

ede autoload tweak

* lisp/cedet/ede/dired.el (ede-dired-minor-mode): Add autoload cookie.
(generated-autoload-file, generated-autoload-load-name):
Set file-local values.

* lisp/cedet/ede.el: Load ede/loaddefs at compile time too.
(ede-dired-minor-mode): Remove hand-written autoload.

* lisp/speedbar.el: Remove some old commentary.

Set Maintainer to emacs-devel in some lisp/url files.

Manage reftex's internal autoloads automatically

* lisp/textmodes/reftex.el: Manage most autoloads automatically.

* lisp/textmodes/reftex-auc.el, lisp/textmodes/reftex-cite.el:
* lisp/textmodes/reftex-dcr.el, lisp/textmodes/reftex-global.el:
* lisp/textmodes/reftex-index.el, lisp/textmodes/reftex-parse.el:
* lisp/textmodes/reftex-ref.el, lisp/textmodes/reftex-sel.el:
* lisp/textmodes/reftex-toc.el: Set generated-autoload-file,
and add autoload cookies for reftex.el.

* lisp/Makefile.in (AUTOGEN_VCS): Add textmodes/reftex.el.

* (make-dist): Update AC_INIT regexp.